home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 March / EnigmA AMIGA RUN 05 (1996)(G.R. Edizioni)(IT)[!][issue 1996-03][Skylink CD IV].iso / earcd / comm2 / alist.lha / README < prev    next >
Text File  |  1995-11-08  |  8KB  |  169 lines
  1.  
  2. ***************************************************************
  3. *** WARNING:  This archive is protected under version 2.0   ***
  4. ***           of the GNU Public License (GPL).  Permission  ***
  5. ***           is explicitly given for distribution on       ***
  6. ***           Public Domain archives of every kind, which   ***
  7. ***           includes, but not exclusively, CDs and disks, ***
  8. ***           such as the Fred Fish and Aminet collections, ***
  9. ***           provided only a minimal fee is charged.  This ***
  10. ***           archive may only be distributed WITHOUT ANY   ***
  11. ***           modifications.  Modifications may be sent to  ***
  12. ***           the author (thought@weblink.org) for inclus-  ***
  13. ***           ion in the distribution.  No warranties are   ***
  14. ***           given or implied.                             ***
  15. ***************************************************************
  16.  
  17. AList is a happy little server software thingy.  (:
  18.  
  19. I haven't had the time to add in all the features it'll have
  20. eventually, but I will get around to it.  If you code up some
  21. nice little addition, or fill in some of the 'missing' features,
  22. please let me know, and I'll fold your code into the main
  23. sources (giving proper credit, of course).  (:
  24.  
  25.  
  26. REQUIREMENTS:
  27.    AList requires OS 2.04+, AmiTCP (preferably 4.0+), and
  28. INetUtils 1.4+ (which can be found on the Aminet) or something
  29. with functionality exactly the same as SMTPPost.  It was
  30. tested ONLY on an accelerated A2000 with OS 3.1, AmiTCP 4.0demo,
  31. and INetUtils 1.4.
  32.  
  33.  
  34. FILES:
  35.    The following files should be found in this archive.  This
  36. archive MUST remain intact, unless specific permission is given
  37. by the author(s).
  38.  
  39.    AList       The server itself
  40.    ALSend      The command used by the SMTPd or other mail system
  41.                   to process incoming mail to AList.  This will
  42.                   automatically attempt to start AList if it isn't
  43.                   already running.
  44.    ALQuit      The command used to quit AList.  It will not return
  45.                   until AList is finished doing whatever it has
  46.                   been told to do so far.
  47.    src/        The complete sources to all included binaries are
  48.                   found in here.  They are coded in E v3.2, but
  49.                   should compile fine in E v3.1. Note that if you
  50.                   intend to compile the AList server itself, you
  51.                   need a registered version of E, due to it's size. *
  52.    src/aladd.e, aladdr.e, alcmd.e, alconfig.e, aldef.e, allog.e, alpost.e
  53.                The modules used in the alist.e program.  Compiled
  54.                   versions may be found in the m/ directory, and will
  55.                   probably be necissary at first due to the fact that
  56.                   most are recursive.  (:  All modules require the LARGE
  57.                   memory-model flag when compiling.
  58.    src/alist.e
  59.                The main AList part.  Requires the LARGE memory-model flag.
  60.    src/alsend.e
  61.                The complete ALSend source.  Requires aldef.m.
  62.    src/alquit.e
  63.                The complete ALQuit source.  Requires aldef.m.
  64.    m/
  65.                This directory contains all of the modules in src/
  66.                   compiled.  I'm including these due to the fact
  67.                   that most of them are recursive with each other.
  68.                   They should be copied to the EMODULES:other/
  69.                   directory, which is where the programs in src/
  70.                   will be looking for them.
  71.    README
  72.                This file.  Duh.  (:
  73.    test.list
  74.                The sample list config file.  DO NOT DELETE OR MODIFY!
  75.  
  76.  
  77. * - The E language may be found on the Aminet, under dev/e.
  78.  
  79.  
  80. INSTALLATION:
  81.    The files 'AList', 'ALSend', and 'ALQuit' should all be
  82. somewhere (doesn't matter) in the command path.  The
  83. environment variable AList_Config should be set to the
  84. complete path where the AList.Conf file resides.  The HOSTNAME
  85. environment variable should be set to the full name of your
  86. computer.
  87.  
  88.    The following lines need to be inserted into your aliases
  89. file:
  90.  
  91. # AList mailing list server
  92. AList:: "|alsend"
  93. AList@yoursite.domain:: "|alsend"
  94.  
  95.    The second line is necissary because for some reason the SMTPd
  96. doesn't expand "name@site" aliases when sending locally, so it'll
  97. end up in a mailbox instead of being piped to ALSend.  If you can
  98. manage to get it to expand "name@site", you won't need that second
  99. line above, or any of the similar "name@site" lines below.
  100.    Additionally, for each list, you'll need the following lines:
  101.  
  102. # <listname> mailing list
  103. listname:: "|alsend"
  104. listname@yoursite.domain:: "|alsend"
  105. listname-list-owner:: "|alsend"
  106. listname-list-members: >NIL:
  107. listname-list-members@yoursite.domain:: "|alsend"
  108.  
  109.    In addition to those, the following lines are optional, but will
  110. be recognized correctly by AList:
  111.  
  112. listname-list:: "|alsend"
  113. listname-request:: "|alsend"
  114. listname-list-request:: "|alsend"
  115. listname-owner:: "|alsend"
  116.  
  117. where listname is the name of the list.  You can also add in
  118. @yoursite.domain lines if you plan on using the fully qualified
  119. name locally.  The two listed I highly recommend, the first because
  120. replying to a message locally will send to it, and the second because
  121. it will generate a mailbox for it at every post otherwise.  However,
  122. the @yoursite.domain versions of the other lines will only get used
  123. if you specify them yourself when mailing locally.  And if you can
  124. follow the last several sentences, you're doing much better than I am.
  125. *grin*
  126.  
  127.    You'll need to copy the file "test.list" to "listname.list", where
  128. "listname" is the name of each list you added.  Something to remember
  129. is that you need to set up every digest version of a list just like
  130. you would any other list, including the entries in the aliases file
  131. and its own listname.list file.  The "test.list" file is documented,
  132. though MANY of the features aren't enabled yet.  Here's a list of the
  133. ones which are currently unused:
  134.  
  135.    Password, AutoCmd, ApprovePwd (although, AList WILL remove any
  136. "Approved: " headers, so you don't have passwords being sent out),
  137. all of the Moderate..., File[Get|Put]Pwd (obviously, since GET and
  138. PUT aren't implimented), Welcome, Decrypt/Encrypt, KeepReceived,
  139. KeepHeaders, and RequireKey (also obvious, since SETKEY isn't yet
  140. implimented).
  141.  
  142.    There are also a few unlisted ones, which only appear in a file
  143. generated and maintained automatically by AList called "listname.issue".
  144. These should NEVER be used, as they affect the internal workings of the
  145. digest processing.
  146.  
  147.    Also, in lists which are digests of other lists, there is currently
  148. NO checking for digest information, so be EXTREMELY CAREFUL to make sure
  149. ALL fields starting with "Digest" are commented out!!!  Also, since the
  150. ModerateXxx and ApprovePwd fields aren't yet implimented, the only way
  151. to prevent anyone from posting to a digest is currently to not include
  152. it in the aliases file.  The posting command for it is called directly
  153. internally, so no alias is really needed unless you want to be able to
  154. manually post to it.
  155.  
  156.  
  157.    Well, that about wraps it up.  If you have any questions, comments,
  158. bugs, or additions you've hacked out, by all means send them to me at
  159. thought@weblink.org and I'll respond as soon as I can.  (:
  160.  
  161.    The AList homepage can be found at
  162. http://www.weblink.org/weblink/AList.html where the most recent version
  163. of the archive may always be found.  Also, be sure to check out the
  164. WebLink home page while you're there, at http://www.weblink.org/weblink/
  165.  
  166. Jesse McClusky
  167. thought@weblink.org
  168.  
  169.